home *** CD-ROM | disk | FTP | other *** search
/ Utilities Professional 1-1500 / Utilities Professional 1-1500 (1994)(WPD)[!].iso / 12511500 / var1361.dms / var1361.adf / fastgif / FastGIF2.doc < prev    next >
Text File  |  1993-03-31  |  9KB  |  320 lines
  1.  
  2.                               FastGIF II V1.01
  3.                     (c) 1992,93 by Christophe PASSUELLO
  4.                    -------------------------------------
  5.  
  6.  
  7.     FastGIF II is The GIF viewer. This new version has been rewritten, now
  8.     there is a real user interface, a file-requester, gadgets, and also
  9.     short-cut, now you can display picture in a screen as before and in a
  10.     WorkBench window. FastGIF II takes advantage of the new AGA chipset.
  11.     It's always the FASTEST GIF viewer on Amiga.
  12.  
  13.  
  14.     FastGIF II is now SHAREWARE, so if you use it often send me a contribution
  15.     of 10 US$ or 50 French Francs (bills only), you will receive the registred
  16.     version of FastGIF II with IFF saving. If you live out Europa add 4 US$
  17.     or 20 French Francs for mailing.
  18.  
  19.  
  20.     FastGIF can't be sold alone or in any package, but you can freely
  21.     distribute it on PD's disks (like Fred Fish one) or on any BBS only if
  22.     complete and unmodified. Distribution of registred version is FORBIDEN.
  23.  
  24.  
  25.  
  26. DISCLAIMER
  27. ----------
  28.  
  29.   The author isn't responsable of any damages resulting of FastGIF II use.
  30.  
  31.   Before starting FastGIF II, you must be sure to have the Reqtools.library
  32.   and the iff.library (for registred version) in your LIBS: directory.
  33.  
  34.  
  35. PRESENTATION
  36. ------------
  37.  
  38.      FastGIF II displays pictures with more than 32 colors using gray-scale,
  39.   and using color if the picture don't have move than 32 colors. If you own
  40.   a new Amiga with AGA chipset (A1200 & A4000), display will use colors even
  41.   with a 256 colors picture.
  42.  
  43.     FastGIF II has been succesfully tested on a A1200 with WorkBench 1.3, there
  44.   is still some little problems with AGA chipset, the palette used is a 12 bits
  45.   palette instead of a 24 bits palette, and when you use hires switch during
  46.   display the image may look strange, these little problems will be fixed as
  47.   soon as i will receive docs about the new libraries of WorkBench 3.0.
  48.  
  49.  
  50. BAD
  51. ---
  52.  
  53.   - It uses a lot of memory (loading file in RAM), allocates large block (320Kb
  54.     for a 640 * 512 pixels pictures).
  55.  
  56.  
  57. GOOD
  58. ----
  59.  
  60.   - Now with a user interface, file-requester, iconify and so on.
  61.  
  62.   - Very fast, mains routines are written using very highly optimised assembler
  63.     (twice faster than TurboGIF)
  64.  
  65.   - It should be even faster with 32 bits cards because the assembly routines
  66.     are small enough to fit in the cache. (I suggest you to set on the cache
  67.     instruction using CPU or SetCPU)
  68.  
  69.   - It should display GIF89a files (I don't have GIF89a files so if it doesn't
  70.     works send-me some GIF89a files)
  71.  
  72.   - It should works on NTSC or PAL. (i don't have NTSC)
  73.  
  74.   - You can scroll picture.
  75.  
  76.   - It handles corrupted GIF files
  77.  
  78.   - Completly multitasking
  79.  
  80.  
  81.  
  82. RUNNING FASTGIF II WITH CLI
  83. ---------------------------
  84.  
  85.   You can use one option:
  86.  
  87.     Usage: FastGIF [-low]
  88.  
  89.     -low      : This can you help when you are low on memory, with this option
  90.                 you can display a 640*512 picture with 512 KB CHIP and 512 KB
  91.                 FAST.
  92.  
  93.    I suggest you to set this option in FastGIF II using the Options Window.
  94.  
  95.  
  96.  
  97. RUNNING FASTGIF II WITH WORKBENCH
  98. ---------------------------------
  99.  
  100.    Just double-click on the FastGIF II 's icon. You can set the following Tools
  101.    Types before running (With Info item of WorkBench menu).
  102.  
  103.      CHIPAGA=ON  to use AGA chipset
  104.      LOWMEM=ON   if you don't have much memory.
  105.  
  106.    This options can be set in FastGIF II using the Options Window.
  107.  
  108.  
  109.  
  110. HOW TO USE FASTGIF II
  111. ---------------------
  112.  
  113.   Once loaded, you can see 6 buttons and two text areas, the small one gives
  114.   information about the current file, the big one tells what FastGIF II is
  115.   doing. Underlined letter are short-cut.
  116.  
  117.  
  118. I BUTTON LOAD
  119. -------------
  120.  
  121.    Opens a file-requester, if you choose  a file it will be loaded in ram and
  122.    decompressed, picture size and so on will be printed on Information area.
  123.  
  124.    If you wait until the file requester has scanned all the directory, the
  125.    next time you won't have to wait: the directory will be in the buffer.
  126.  
  127.  
  128. II BUTTON VIEW
  129. --------------
  130.  
  131.    First open a window with viewing options:
  132.  
  133.     - You can choose between a screen and a WorkBench window for displaying
  134.       pictures. If you choose the WB window, the WorkBench must have enough
  135.       colors else the picture will be converted in gray-scale if the WorkBench
  136.       has at least 16 colors. With this mode 256 colors graphics cards that
  137.       emulate WorkBench may works (Tell me if it works)
  138.  
  139.     - For screen display you can choose hires, interlace and overscan.
  140.  
  141.     - For gray-scale converted picture you can choose brightness and contrat.
  142.       Contrast can greetly improve the quality of picture (a value of 15 is
  143.       usually enough).
  144.  
  145.  
  146.    * Once the screen is displayed you can use the following keys:
  147.  
  148.      L      : switch Interlace
  149.      H      : switch Hires
  150.      O      : switch Overscan
  151.      ESC    : close the screen
  152.  
  153.     To scroll picture use cursor keys, with SHIFT scrolling will use 16 pixels
  154.     step, with ALT you to go to border of the screen. Click on right mouse
  155.     button to close the screen.
  156.  
  157.  
  158.    * Using WB window:
  159.  
  160.      You can change window size, use scroller to scroll picture in window,
  161.      using the CloseWindow gadget or ESC key you will close window.
  162.  
  163.  
  164. III BUTTON SAVE
  165. ---------------
  166.  
  167.    WARNING! IFF saving is only available with registred version.
  168.  
  169.     A requester let you choose options:
  170.  
  171.      - You can choose to save the picture with all its colors (Without
  172.        conversion) or to convert picture to gray-scale (contrast and bright-
  173.        ness are those used in VIEW part.)
  174.  
  175.      - Compression tells if you want to compress pictures, no compression is
  176.        useful if you power-pack pictures.
  177.  
  178.     A filerequester let you choose the filename.
  179.  
  180.  
  181. IV BUTTON ABOUT
  182. ---------------
  183.  
  184.    Tells some info about FastGIF II.
  185.  
  186.  
  187. V BUTTON OPTIONS
  188. ----------------
  189.  
  190.    This will allow you set FastGIF II options:
  191.  
  192.     - 256 Colors must be set to use 256 colors modes (You must have AGA chipset
  193.       or may be a 256 colors graphic card).
  194.  
  195.     - Low memory may help you if you are low in memory.
  196.  
  197.     - Will free memory used by current file when iconified, so once iconifed
  198.       FastGIF II will only use 40 KBytes of memory.
  199.  
  200.  
  201. IV ICONIFY
  202. ----------
  203.  
  204.    Just iconify FastGIF II.
  205.  
  206.  
  207.  
  208. TO DO
  209. -----
  210.  
  211.   - Using colors instead of grey-scale for pictures with more than 32 colors. ?
  212.  
  213.  
  214. AUTHOR
  215. ------
  216.  
  217.    Send me any suggestion, bugs-report, flames, donations, etc....
  218.    I'am looking for docs about the new graphics.library of WorkBench 3.0
  219.    especially how to use the 24 bits palette of AGA chipset (prototypes and
  220.    LVOs). I'm looking also for docs about PCX, PIC and BMP file format.
  221.  
  222.    For bugs-report send informations about your config:
  223.    FastGIF version, witch processor, version of Workbench, how many RAM you
  224.    own (CHIP & FAST), ...
  225.  
  226.  
  227.    You can contact me at the following address:
  228.  
  229.         Christophe PASSUELLO
  230.         25, Rue du Plateau
  231.         91600 SAVIGNY SUR ORGE
  232.         FRANCE
  233.  
  234.  
  235.  
  236. CREDITS
  237. -------
  238.  
  239.   * FastGIF II uses the great ReqTools.library, copyright (c) by Nico François.
  240.   * Iconify routine based on Iconify by Leo L. Schwab (available on Fred Fish
  241.     Disk 126).
  242.   * GIF Format is Copyright (c) CompuServe Incorporated.
  243.   * iff.library is Copyright (c) Christian A. WEBER.
  244.  
  245.  
  246.  
  247. HISTORY
  248. -------
  249.  
  250.  - RELEASE V1.00
  251.  
  252.       First release
  253.  
  254.  
  255.  - RELEASE V1.02
  256.  
  257.       Decompression 5% faster.
  258.       Bug fixed : ScrollVPort doesn't works very well with Interlaced. I use
  259.       MakeScreen and ReThinkDisplay instead.
  260.  
  261.  
  262.  - RELEASE V1.10
  263.  
  264.       Now can display pictures with more than 32 colors in gray-scale.
  265.       Pictures are now centered in the middle of the screen.
  266.  
  267.  
  268.  - RELEASE V1.11
  269.  
  270.       Internal release.
  271.       Fast scrolling added.
  272.  
  273.  
  274.  - RELEASE V1.12
  275.  
  276.       New algorithm for decompression: 25 % FASTER.
  277.  
  278.  
  279.  - RELEASE V1.13
  280.  
  281.       Bug fixed: palette colors wasn't good.
  282.  
  283.  
  284.  - RELEASE V1.14   (Sep 15 1992)
  285.  
  286.       -low option added.
  287.  
  288.  
  289.  - VERSION V1.20   (Oct 1 1992)
  290.  
  291.       GIF parsing completly rewritten, much safer than before.
  292.       Now support GIF89a files.
  293.       Options for contrast and brightness added.
  294.       GIFInfo added to the archive.
  295.  
  296.  
  297.  - VERSION FASTGIF II V1.00   (Jan 31 1993)
  298.  
  299.       Completly rewritten version.
  300.       Now FastGIF II is SHAREWARE.
  301.       Intuition User Interface added (Gadgets, requester, iconification).
  302.       There is now a filerequester.
  303.       Viewing routine rewritten.
  304.       You can now view pictures in a Workbench window.
  305.       You can run FastGIF II from WorkBench
  306.       LZW decompressing 68020+ version added.
  307.       Now supports the new AGA chips.
  308.       IFF saving added (with registred version).
  309.  
  310.  
  311.  - VERSION FASTGIF II V1.01   (Feb 04 1993)
  312.  
  313.       Now cut corrupted part of the picture.
  314.       Small bug in the text area fixed.
  315.  
  316.                        -------------
  317.  
  318.  
  319.                         Enjoy FastGIF !!!!!!!!!!!
  320.